# AchievementManager.unlockAchievement(Object option)
以 Promise 风格调用:不支持
# 功能描述
解锁指定的成就。调用后如果成功,用户会收到成就解锁的提示(如果启用了 toastEnable)。
# 参数
# Object option
属性 | 类型 | 默认值 | 必填 | 说明 |
achievementId | string | 是 | 要解锁的成就ID |
# 注意事项
- 成就ID必须是在TapTap开发者平台配置过的有效成就ID
- 如果成就已经解锁,重复调用不会有任何效果
- 解锁结果会通过注册的监听器回调通知
# 示例代码
const achievementManager = tap.createAchievementManager({
toastEnable: true
});
// 注册监听器以接收解锁结果
achievementManager.registerListener({
onAchievementSuccess: (code, achievement) => {
console.log('成就解锁成功!');
console.log('成就名称:', achievement.achievementName);
console.log('成就类型:', achievement.achievementType === 0 ? '普通成就' : '白金成就');
},
onAchievementFailure: (id, code, msg) => {
console.error('成就解锁失败:', msg);
}
});
// 解锁成就
achievementManager.unlockAchievement({
achievementId: 'first_win' // 替换为实际的成就ID
});
// 解锁白金成就
achievementManager.unlockAchievement({
achievementId: 'master_player'
});